home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #2 / Ham Radio 2000 - Volume 2.iso / HAMV2 / PACKET / TOP153EN / DDE.TXT < prev    next >
Encoding:
Text File  |  1997-02-12  |  3.0 KB  |  92 lines
  1. DDE Specification for WinPack V6.2
  2. ----------------------------------
  3.  
  4. (You must know something about DDE to understand this!)
  5.  
  6. Server Name: Packet
  7.  
  8. Topic Name: WinpDDE
  9.  
  10. Item Names: txtDDE
  11.             labDDE2        (not supported before V6.2)
  12.             labDDEStatus   (not supported before V6.2)
  13.  
  14. txtDDE is retained to maintain compatibility with the DDE support in
  15. WinPack before V6.2. It is recommended that any new applications
  16. using DDE links should use labDDE2 and labDDEStatus.
  17.  
  18. Item Usage
  19. ----------
  20. Links can be established to all three items to allow your program to
  21. be notified when the data in the items changes. You can use
  22. automatic, notify or manual links.
  23.  
  24. txtDDE
  25. ------
  26. This item receives all monitored data when WinPack is not connected
  27. and all connected data. If WinPack is in BPQ mode or host mode,
  28. monitored data is not sent whilst a connection is in progress, even
  29. though it is available. Data is not sent if WinPack is either
  30. involved in a Yapp transfer or uploading/downloading compressed
  31. mail. The item is cleared before it is updated, so your program will
  32. see two transactions - one with an empty string - each time txtDDE
  33. is updated. This is done because if the item is updated with
  34. identical data, VB does not trigger a DDE transaction, so if an
  35. ASCII file transfer was occurring in which two successive lines were
  36. identical, the client application might only see one line.
  37.  
  38. labDDE2
  39. -------
  40. This item behaves exactly like txtDDE, except that the problem of
  41. making sure the client sees every update is handled differently. The
  42. first character of the data is alternately '0' or '1'. You should
  43. discard the first byte when the data is received.
  44.  
  45. labDDEStatus
  46. ------------
  47. Every time WinPack's connected status changes, this item is updated
  48. with the connected status information - see below.
  49.  
  50. Link Execute
  51. ------------
  52. If an execute transaction is sent to the server, the command string
  53. is normally sent to the TNC. There are two exceptions:-
  54.  
  55. If the command string is "<ESC>[STATUS]" then txtDDE is updated with
  56. connected status information.
  57.  
  58. If the command string is "<ESC>[STATUS2]" then labDDEStatus is
  59. updated with connected status information. This is only needed when
  60. an application first starts, because once WinPack has some DDE
  61. clients, labDDEStatus is automatically updated whenever the
  62. connected state changes.
  63.  
  64. In the above, <ESC> means the character 1B hex.
  65.  
  66. Connected Status Information
  67. ----------------------------
  68. This consists of a few lines of text.
  69.  
  70. Line 1: "<ESC>[STATUS]" or "<ESC>[STATUS2]" according to which item is
  71. being used.
  72.  
  73. Line 2: "*** CONNECTED to a_callsign" e.g. "*** CONNECTED to G4IDE",
  74. or "*** DISCONNECTED".
  75.  
  76. Line 3: "CTS=state".
  77.  
  78. Line 4: "DSR=state".
  79.  
  80. Line 5: "DCD=state".
  81.  
  82. Line 6: "DDE link count=number_of_current_DDE_links".
  83.  
  84. In the above, state can be "TRUE", "FALSE", "NULL" (DCD only), or,
  85. if you are using BPQ or host mode, it is the first five characters
  86. of the name of the mode in use, e.g. "BPQ" or "TF2.7".
  87.  
  88.  
  89. Roger Barker, G4IDE
  90. February 1997
  91.  
  92.